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Author: Donald C.(Sinokey) Wallace 

Contributions: The immediate world 

This is a working version of the BSYS documentation 

and as such is subject to correction and change. Please 

address any correspondence to: 

C. A. Untulis - UNTULISaSRI 
Stanford Research Institute 
333 Ravenswood Drive 
Menlo Park Calif* 
(415>32&-6200 x4470 



Abstract : 



BSYS is a subsystem for the TOPS20 and TEi\'EX timesharing systems* It 
provides facilities for dumping* restoring and archiving user files* 
It is also a file system utility allowing a wide variety of functions 
for verifying* examining and fixing file system problems* In 
philosophy it is intended as an extension of the T0PS20 file system to 
magnetic tape storage* allowing file name recognition* directories 
etc. The descriotions will be relative to a TOPS-20 system. 
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INTRODUCTION 

The backup system (BSYS) has three main purposes: 

Protection for both the user and the system against catastrophic Loss 
of data (f 1 les >• 

Automatic (or manual if desired) file saving and deletion of inactive 
(not referenced ) files. In this manners it also provides for another 
Level of file storage. 

A general file system utility for verifying user directories* 
deleting extra versions* and a wide variety of useful operations on the 
file system. 

CONVENTIONS 

In writing this document* tKe following conventions are used: 

1) Instructions about things to do are enclosed in parentheses. 
Ex: (mount dectape on unit 0) 



2) When describing interactions with the system* characters typed 
by the user ar 
are Lowercase. 



y the user are capitaLizedtand characters typed b" the systeni 



3) Special control characters will be described with the following 
notat ions : 

a) <ALT> is an Altmode or Escape 

b) <CR> is a Carriage Pveturn 
c> <SP> is a Space 

d)<'^D> isaControlD 

e) <'^C> is a Control C* etc. 

4) In How -to -do- it scenarios semicolon is used to delineate 
comments as in the EXEC comment convention and PDPIO Macro 

5) # - is used to signify the operator is to enter a number 

6) MUL: - is used on TOPS-20 System 

7) nil: - is used on TENEX System 

8) . - is used before the generation number on TOPS-20 System 

9) ; - is used before the version number on TENEX System 

10)A carriage return <CR>in response to a "listing to" questiion 
defaults to TTY: 
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General Description 



BSYS d'jrrips provide an additional level of file storage to the 
T0PS2G timesharing system* They fundamentally do a "page" copy of a 
file group to magnetic tape storage* BSYS dumps differ from 
OuTiper in that the tapes produced by BSYS have directories and 
33 such "know" where a file is on the tape and can position directly 
to the desired file (forward or backward). The directory also allows 
the listing of a specific tapes contents* 

Information about the last dump tape number plus the time and date 
of the last dump is maintained in the FOB of each file in the 
file system. This data is only updated for Full and Full Incremental 
dumps. This allows you to do as many directory dumps as you like 
without affecting any systematic dumping/retrieving process being 
done by you local operations staff. This inforfnation should aid in 
recovering sniashed of otherwise destroyed files from dump tapes. 



SPECIAL NOTE ** 
You must let BSYS unload a tape or return to prompt the 
operator with ♦**" or a question before you can deselect that 
unit. If you do not the tape will be no good!! BSYS "rewrites" 
the directory on the front of each tape. The common nini-dumper 
practice of deselecting the tape unit at rewind time 1s 
disastrous when using BSYS. Due to a completion marking 
mechanism the files would be redumped on a subsequent dump 
(incremental) but the dumped data and time used is lost. 
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Dumping the entire file system 

yhataFullDumpdoes 

The Full Dump function of BSYS copies the entire file system 
onto Tiagnetic tapes. This process takes about 1/2 hour per tape 
An 800 BPI tape contains approximately 5000 pages and a 1600 BPI 
doubles that amount. 

How to do a Full Dutio 



1. n 

w 

2. L 

SEna 
I 

(s 

t 

* 

en 
li 



ount blank tapes on tape units and be sure they have 

rite rings in them!!! 

ogin as a user with OPERATOR (WHEEL) capabilities* 

ble 

BSYS<CR> 

ite name) -( system) -bsys version date 

ype cntrl-d to abort type in» cntrl-p cntrl~c to abort run 

F<ALT>ull dump (entire file system)<CR> 

ter tape unit mta # 

i U - type proper unit number 
sting to file <cr> for tty: (site's choice)<CR> 

; ie: lpt:» tty: ♦. 

ape r,j(nber 1i<C?.> 

♦ # - type tape number on tape reel 

The dump should now be running...* 

When BSYS has filled up the first tape» it rewinds 

that tape* writes the tape directory at the front of 
the tape and instructs 

the operator to: 



f .1- 



enter tape unit mta # 

» # - next unit number 
tape number S<CR> 

; # - the tape number of next tape 
; When the dump is completed (last tape rewinds)t 
; You must wait for the "*"• 
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Dufnp'^ng a User DirectoryCs) 

yhatOumpDirectorydoes 

The Directory Dump function of BSYS copies an entire user 
directory onto magnetic tapes* The Length of time required to do 
this operation is a function of the system load and the total 
number of pages in the specific userdirecto ry. At the end of 
dumping each directory the operator is given the opportunity to 
specify another directory. 

How to do a Dump Directory 



1» Mount olank taoes on tape units and be sure they have 

write rings in them!!! 
2* Login as a user with OPERATOR(UHEEL) capabilities* 

SEnable 

!BSYS<CR> 
(site name) -( system) -bsys 

type cntrL-d to abort type 

*DU<ALT>mp d ir e ctor y<CR> 



version date 
in» cntrl-p cntrl-c to abort run 



Pr i vi leg 



Directo 
List of 



enter ta 

; # 

Li sti ng 
; ie 

tape nu 

; n 

enter t 
; Li 
; The d 
; When 
; that 
; the t 
; opera 



ed 
» a 
;hi 
ry: 
fit 

;ye 
;te 

pe 

- t 
to 

: L 

mbe 

- t 
ape 
ke 
ump 
BSY 
t ap 
ape 
t or 



user 
non 
s ow 
FOO 
es? 
S pe 
rmin 
unit 
ype 
file 

pt:, 

r U< 
ype 

id: 
" D um 

sho 
S ha 
e* w 
9 an 

to: 



? Y 
p ri 

n d 
BAR 
Mo< 
rmi 
ate 

mt 
pro 

<c 

TT 
CR> 
tap 

TE 
P 
uld 
s f 
rit 
d i 



es< 
vil 
ire 

<CR 
CR> 
ts 
d b 
a # 
per 
r> 
y: 



CR> 

eged user can only dump 

ctory* 

> 

a List of files to be selected 
y a blank L ine. 

unit number 
for tty: <CR> 



e number on tape reel 

XT*..<CR> 

f <FOOBAR>" 

now be running*** 
illed up the first tape* it rewinds 
es the tape directory at the front of 
f it needs another tape instructs the 



enter tape unit mta # 

;# - the proper unit number 
tape number #<CR> 

;# - the tape number of next tape 



; When the dump is completed (last tape rewinds)* 
; You must wait for the "*"* 
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Incremental Dumos 



What an Incremental Dump does 

The Incremental Dump function of BSYS copies all files that 
have been written since either the last du;T,p or since a specified 
date and time onto magnetic tapes* 

How to do an Incremental Dump of the entire file system 



and be sure they have 
capabi li ti es. 



!• Mount blank tapes on tape units 

write rings in them!!! 
2. Login as a user with OPERATOR (WHEEL) 
SEnable 

!BSYS<CR> 
(site name) -( system)-bsys version date 

type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 

*IiMC<ALT>remental dump (changed files)<CR> 



dump sine 
enter dat 

» 

entire f 
enter tap 

listing t 
; ie: 

tape n J m 
; # - 
The du 
When B 
that t 
the ta 
operat 



e date and time(y or n)? Yes<CR> 

e and time: MO/DA/YR HH:MM<CR> 

or any valid IDTIM format 

If NO is specified then BSYS dumps all 

files changed since the last dump. 

ile system? Yes<CR> 

e unit mta # 

type proper unit number 
o file <cr> for tty: (site's choice)<CR> 

lpt:, tty: .. 

ber #<CR> 

type tape number on tape reel 
mp should now be running**. 

SYS has filled up the first tape» it rewinds 
ape» writes the tape directory at the front of 
pe» and if it needs another tape instructs the 
or to: 



enter tape unit mta # 

; # - next unit number 
tape number #<CR> 

; # - the tape number of next tape 
; When the dump is completed (last tape rewinds)* 
; You must wait for the "*". 
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How to do an Incremental Dump of a specific directoryCs) 

!• Mount blank tapes on tape units and be sure they have 

write rings in them!!! 

2» Login as a user with OPERATOR(WHEEL) capabilities. 

2 E n a b I e 

! 3SYS<CR> 
(site name) -( system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 
* INC<ALT>remental dump (changed files)<CR> 



dump 
ents 



ent 
Pr iv 

dir 
List 
type 

ent 

list 

new 



sin 
r da 
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ileg 
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of 

til 
er t 
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ing 
; ie 
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T 
W 
t 
t 
o 



"a 
th 
as 
nu 

; # 

he d 
hen 
hat 
he t 
pera 



ce date 
t e and 



file sy 
ed user 
ry; FOO 
files? 
e list» 
ape uni 

- type 
to file 

: lpt:» 

? Yes C 
s we ring 
p p e n d " 
e folio 
ked in 
mber #< 

- type 
ump sho 
BSYS ha 
t ape ♦ w 
ape^ an 
tor to: 



and 
time 
; or 

; If 
; fi 

stem 
? Ye 

BAR< 
Yes< 

ter 
t mt 
prop 

<cr 

TTY 
conf 

the 
file 
wing 
the 
CR> 
t ape 
uld 
s fi 
rite 
d if 



t ime (y 
: MO/DA 

any va 

NO is 
les cha 
^ ISio<CR 
s<CR> 
CR> 
CR> 

minated 
a # 

er unit 
> for t 
• • • 
i rm3<CR 

preced 
s to th 

quest i 
NO case 

number 
now be 
I led up 
s the t 

it nee 



or n)? Yes<CR> 

/YR hh:mm<cr> 

lid IDTIM format 

specified then BSYS dumps all 

nged since the last dump. 

> 



with nu 1 1 li ne : 



number 
ty: <CR> 



ing question NO allows you to 
e end of an existing BSYS tape 
on will not be 



on tape reel 
running. • • 

the first tape^ it rewinds 
ape directory at the front of 
ds another tape instructs the 



enter tape unit mta # 

I U - next unit number 
tape number #<CR> 

; # - the tape number of next tape 
; When the files for the given directory have been 
; dumped^ you may select others., 
more users? No<CR> 
; When the dump is completed (last tape rewinds)* 
; You must wait for the "*"• 
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Continuing Dumps 



What Continue Dunfip does 




How to Continue a Dump 



1. 



2. 



Mount b 

write r 

compLet 

Login a 

S Enable 

!8SYS<C 

(site na 

type en 

*CONT<A 

; at 

; "M 

; if 

enter ta 

• 4* 

list i ng 
; ie 
tape n J 

•» n 

dump re 



lank tapes on tape units and be sure they have 

ings in them!!! Be careful not to use any previously 

ed dump tapes* 

s a user with OPERATOR (WHEEL) capabilities. 

R> 

me) -( system) -bsys version date 

trl-d to abort type in» cntrl~p cntrl-c to abort run 

LT>inue dump<CR> 

this point you may get the message 
o continue record?? entering manual mode" 

this happens go to "manual mode" below 
pe unit mta U 

- type proper unit number 

to file <cr> for tty: (site's choice)<CR> 

: lpt:» tty: .. 

mber #<CR> 

- type tape number on tape reel 
started at user name 



; The dump should now be running... 

; When BSYS has filled up the first tape* it rewinds 
; that tape and writes the tape directory at the front of 
; the tape* and if it needs another tape instructs the 
» operator to: 

enter tape unit mta # 

; # - next unit number 
tape njmber #<CR> 

; # - the tape number of next tape 
; When the dump is completed (last tape rewinds)? 
; You must wait for the "*"• 
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4. Manual mode 

; this is caused by one of two things 

i 1) you are not realty continuing a dump 

; 2) BSYS screwed up in writing the continue date and you 
must now supply it» This is analogous to a normal dump 
(full or incremental) except you have the option of which 
directory to start dumping. 
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LOAD/RESTORE 
General description 

LOAD AND RESTORE are the commands used to copy files from magnetic 
tape storage to the active file system, LOAD is used if the desired 
resultant file is to be a new file» That is it should retain none of 
its original attributes except the data*(ie: creation datetarchive 
status^ etc..) RESTORE is used if the file is to reappear in the 
file system exactly as it was when it was dumped or archived. 

Load files (from magtape) 

What load does 

The load command allows copying a file group 

from magnetic tape to the active file system. 

!BSYS<CR> 

(site name) -( system) -bsys version date 

type cntrl-d to abort type in» cntrl-p to abort run 

*LOAD files (from magtape) 

enter tape mta # 

listing to file <cr> for tty: <CR> 

mounting tape directory 

copy mtal: <T APE-DIR>*. SAV;* <ALT> to <DSK-DIR> <ALT> 

;This will cause the save files to be loaded into the 

♦directory on disk. 

mors files (this tape)? No<CR> 

move tapes? No<CR> 

* 

Loading a single file 

!BSYS<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in* cntrl-p cntrl-c to abort run 
*LO<ALT>ad files (from magtape)<CR> 

enter tape unit mta # 

; "#" is the number of the tape unit 
listing to file <cr> for tty: <CR> 

; ie: lpt:» tty: .. 

mounting tape directory 

copy mt3#: <directory>filename.ext;ver<cr> 

; Altmode and ctrl-f can be used to recognize both 
; the tape file's directory name and file name. 

(to) <directory>filemame.ext;ver<cr> 

copy mtan: <'*D> 
*E<ALT>xit<CR> 
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Restore files (from magtape) 

What restore does 

Restore brings back one fiLeCgroup) from a BSYS-cumped tepe» 
and writes it on the disk with the exact characteristics of that 
file when it was originally on-line* i»e.» the directory* name* 
extension* version number* dates* and archive parameters are 
exactly the same» 

How-to procedures 

1) Restoring a single file 

£Enable 
!3SYS<CR> 
(site name) -( sys tem)-bsy s version date 
type cntrl-d to abort type in* cntrl-p cntrl-c to abort run 
*RES<ALT>tore files (from tape)<CR> 

enter tape unit mta # 

; "U" is the number of the tape unit 
listing to file <cr> for tty: <CR> 
; ie: lpt:, tty: .. 
mounting tape directory 
restore (nta#: <D IRECT0RY>FILE.EXT; VER<CR> 

; Altmode and ctrl-f can be used to recognize both 
; the tape filers directory name and file name but not 
; the extension, 
restore nita#: <'*D> 
*E<ALT>xit<CR> 

2) Restoring a single directory 



SEnab le 

!BSys<:alt><cr> 

(site name) -( sys tern) -bsys 



version date 



type cntrl-d to abort type in* cntrl-p cntrl-c to abort run 
*RES<ALT>tore files (from tape)<CR> 

enter tape unit mta # 

; "#" is the number of the tape unit 
listing to file <cr> for tty: <CR> 

; ie: lpt:* tty: •• 

mounting tape directory 
restore mtaUZ <D IRECTORY>*,*; *<CR> 
restore mta#: <'*D> 

; <'*D> - aborts further restore and gets back to BSYS 
;command level 
*E<ALT>xit<CR> 
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Restoring the entire file system 
Descr iot i on 
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In the 
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for restoring the entire file 
restored either from a full dump 
tion of incremental tapes and a 
se the facility to prevent ghosts 
The only requirement is that the 
ent dump (either full or 
This allows BSYS to obtain the most 
M>DIRECTORY;i (for a TENEX system) 
ation as to whether they where 
e system. For TOPS-20 systems^ 
rom the directory files in 



SEnable 
!3SYS<ALT><CR> 

(site n3rne)-( sys tem>-bsys version date 
type cntrl-d to abort type in* cntrl-p cntrl~c to abort run 
*RES<ALT>tore files (from tape)<CR> 

enter tape unit mta # 

; "#" is the number of the tape unit 
listing to file <cr> for ttyl NIL:<CR> 

; ie: lpt:» tty: •• 

mounting tape directory 
restore mta#: <*>*,*;*<CR> 
create users? Yes C conf i rm 3<CR> 

; Users may be created from the first tape of an 

; incremental or full dump. 
» If No is specified BSYS assumes that users already 
; exists and bypasses creating them 

do you wish to bypass restore checks ? No<CR> 

; The file <syst em>di rec tory. ? 1 is taken from the tape and used 

; to check the files as they are restored. 

more tapes ? Yes<CR> 

; The tapes of the next older set of dumps should be 

; processed back to the last full dump. 
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Retrieving a File 

Des cr io t ion 

The retrieve function allows automatic restoring of files 
from tapes. ^^Ihen the user makes a retrieval request^, it is 
entered into <SYSTEM>RETRIEVE-REGUESTS. BINARY* The retrieve 
function periodically examines the contents of this file to 
see if there are any requests to process* If so it 
asks the operator to mount the primary tape and 

the file is automatically restored- If primary is not available 
or the file not found (should never happen) BSYS will Inform 
requestor (file not on first tape — will try second)* The next 
retrieve scans the request list it will ask for secondary tape 
and the file is automatically restored* The user is then sent a 
message describing the status of the request. 

How-to scenario 



©Enable 
!BSYS<ALT>CCR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c to abort 
*RET< ALT>ri eve (archived files) 



run 



Mod 



List 

? ie 

Cont 

if 

fy 

if 

of 
li 

Cont i nu 
Process 
; if 
user 
Proc 
; ei 

; wi 
get 
plea 
ente 
m u n 
; th 
; th 
L isi 
; a 
; un 

;to 
;if 



ing t 
: LPT 
inuou 
yesf 
r e q J e 
yesf 
dele 
st 9 a 
ous C 
Retr 
no» 
: USE 
ess R 
t her 
II gi 
t apes 
se mo 
r tap 
ting 
e dat 
en t h 
a 3 <m 
m e s s a 
less 
exit 
it wa 



file <cr> for tty: <CR> 

tty: 




R-DIR<C 
et ri eva 
the lis 
ve the 

unt (si 
e unit 
tape di 
e and h 
e f i le 
sg-grou 
ge i s s 
the use 
from Re 
s i n CO 



R> 
I R 
t 
mes 
U^ 
te) 
mta 
rec 
ead 
and 

P> 
ent 
r i 
tri 
nti 



equests for local users only? Yes<CR> 
f tapes will be listed or the program 
sage "No retrieval requests to process" 
• • • 
primary tape # ok? Yes C conf 1 rm3CCR> 

rr 

tory 

er info of the tape is. listed 

who requested it are listed 
msgfix*sav;i by user usi — name 

to the user that the file has been retrieved 
s exempt from the message* 
eving you must type CMTRL-C 
nuous mode* 



TAPE COPY 



Description 

Tape copy allows the operator to copy a BSYS tape 
and rebuild the directory on the front of the 



i_ _ j_ 



— ^ _ ^ _i 
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How-to procedures 

1* Flount the tape to be copied and a blank tape on tape units and 
be sure there is a write ring in the tape to be copied to!!! Be 
careful not to use a tape with files recorded on it. 

2» Tape copy of a tape which has a bad begining of tape. 
QEnable 
!BSYS<CR> 

(site name) -C system) -bsys version date 
type cntrl-d to abort type in* cntrl-p cntrl-c to abort run 
*TA<ALT>pe copy <CR> 

listing to file <cr> for tty: <CR> 

enter "froT." tape mta # 

enter "to" tape mta # 

do you want to rewind "from" tape ? No<CR> 

Read header from "from" tape ? No<CR> 

Reconstruct tape header ? Yes<CR> 

(site name) tape number #<CR> 

; # - number to be put on tape 
Enter tape id: TEXT...<CR> 

; otherwise the header id is copied from the "from" tape. 
Copying: 

; the header is listed with the tape number 
» When the copy is completed both tapes are unloaded 
; you must wait for the "*". 



3. Copy of tape that has a good tape header 

aEnable 
!BSY$<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in* cntrl~p cntrl-c to abort run 
*TA<ALT>pe copy <CR> 

listing to file <cr> for tty: <CR> 

enter "from" taoe mta # 

enter "to" tape mta # 

do you want to rewind "from" tape ? No<CR> 

Read header from "from" tape ? Yes<CR> 

Reconstruct tape header ? l\!o<CR> 

Copying: 

; you must wait for the "*"• 
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Loading a Single file 

What single does 

Single also allows you to retrieve a file from a 3SYS-dumped 
tape. however* it differs from restore* in that you can specify 
new file descriptors* rather than simply accept the old ones* 

How-to load a single file 

SJEnable 
!3SYS<CR> 

(site name) -< system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 
*SI<ALT>ngle f i les<CR> 



enter tape unit mta # 
; # ~ tape unit number 
mounting tape directory 
copy mta»:<DIRECTORY>FILENAME.EXT;yER<CR> 

(to) <directory>filename.ext;ver<cr> 

copy mta#: C^D) 

; fd) is the BSYS abort character 
*E<ALT>xit<CR> 
!reset<CR> 

"tape-file-name" must include the directory name* as well as the 
other file descriptors* Altmode can be used to recognize both 
the tape file's directory name and file however* if you use an 
altmode for recognition of the file name* you do not need to type 
the confirming cr. also* if you use an altmode for the 
disk-file-name* you only need 1 (one) confirming cr*} 
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ARCHIVE SYSTEM 

General Description: 

The archive system uses a special form of the BSYS dump facility 
to process the file system and dump user files to magnetic tape. 
Facilities are provided for: 

Specific Archive Requests 

Automatic File Deletion (after archival) 

Autorratic Archival of Files not referenced in "n" days 

Automatic Not i f ica t ion of an operator for ruanual retrieval 

Inquiry for specific file archive inforrnation 

Exempt the directory from archive 

Archive all but the higest version of files 

How-to scenarios 

1> Generating a list of archivable files: 



aEnable 
!BSYSCCR> 

(site name)-( system) -bsys 
type cntrl-d to abort type in» 
*ARCH<ALT>ive (user files)<CR> 



version date 
cntrl-p cntrl-c to abort run 



archival period (days) = #<CR> 
listing only? Yes CConf i rm 3<CR> 

listing to file <cr> for tty: <CR> 

pass-2 ? (y/n)No<CR> 
entire file system? Yes Cconf irm3<CR> 
list for users? No Cconfirm3<CR> 

2) Delivering a list of files to be archived to users: 
*** Not sure of this *** 

note: setup files <ARCHI VE>ARCHI VE-MESS AGE. TXT and 

< ARCH I VE>AR CHI VE-FILES-ONLY.TXT 

SEnaole 

!BSYS<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type int cntrl-p cntrl-c to abort run 
*ARCH<ALT>i ve (user files)<CR> 



archival oeriod (days) = # C Conf 1 rm3<CR> 
listing only? Yes C conf i rm 3<CR> 
entire file system? Yes C conf i rm3<CR> 
list for users? Yes C conf i rm3<CR> 
* * * 
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3) Archiving user files: 



S E n 3 b I e 
!BSYS<CR> 

(site name) -{ system) -bsys version date 
type cntrL-d to abort type in» cntrl-p cntrl-c to abort 
*ARCH<ALT>ive (user files)<CR> 



run 



archival period (days) = #<CR> 
Listing only? No C conf i rm3<CR> 

listing to file <cr> for tty: LPT: 

; ie: LPT:f tty: .. 

pass-2 ? (y/n)No<CR> 

» To insure that there is no mix of pass-1 and pass-2 

; files on the same tape» 
entire file system? Yes Cconf i rm3<CR> 

list for users ? Mo -C conf i rm3<CR> 

enter tape unit mta # new tape ? Yes Cconf irm3<CR> 

really? Yes<CR> 

(site) tape # number #<CR> 
(if new tape = no then BSYS says) 
mountingtapedirectory 

BSYS now types a list of users and data about file archival 



4) Interrogating the magtape archive: 

The EXEC and BSYS command INTERROGATE calls the Csys tem>archi ve- looku: 
program to search the archive-directory file* 
SIMT<ALT>errog3te <DIRNAME>FILE.EXT; VER#<CR> 
All TOPS20 filename conventions apply 

("*»S»T»ALTMODE..ETC. ) . If any groups are specified (*) 
then you will get a list of archived file belonging to that 
group. Only single file retrieval requests are permitted! 
If the file is found in the archive then the user is asked, 
file is archived on tapes xxx and yyy 

do you want it retrieved (y or n) ? YesE con f i rm3 <CR> 
*** filename recognition *** 



;your request has been noted 
» c :T i p I e t e d 



you will be notified when 
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file system UTILITIES 

General Description 

6SYS»s ability to "run" the file system structure (tape directory 
too!) allows the implementation of virtually any utility function 
desired. 

ARCMlS (CLEAR TAPE NUHBER FROM BACKUP WORDS) 
y h a t a r c rn e s does 

ARCMES looks at every fdb in the file system to see if 
the specified tape number is in either the left or right half 
of the archive tape backup word» If it finds the tape number 
in either half* it clears that half of the word. It also clears 
the "deleted" bit in fdbctl to make sure the files isn»t expunged 
before it has a chance to be rearchived* This is useful if 
BSYS or the system crashes when BSYS is "marking" the fdb»s 
after the file has been dumped to tape» 

There is a further check not to delete the number if the file 
was archived 24 hours or more from the present time. 

How to run arcmes 

aEnable 

!BSYS<CR> 

(site name) -( system) -bsys version date 

type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 

*ARCMES<CR> 

Tape number to purge from backup words; #<CR> 

; # - njmber of tape to purge 

Number of hours to go back for purge: #<CR> 

» # - files archived before that time will not be purged of 

; the tape number. 

; Wait until the "*" BSYS prompt is typed 

*EXIT<CR> 

; exit 3 SYS 

COUNT (directory file pages) 

What count does 



Count processes a single directory or the entire file system 
and adds up the number of disk pages in use and produces a report 
of counts by user. As an option it will update the working count 
in the directory overhead block(TENEX only). This option is 
particularly useful when enforcing the disc allocation option in 
TENEX versions 130 or later. 
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How to rjn count 

counting a single directory 
aiEnable 

!bsys<c:r> 

(site name ) ~ ( system) -bsys version date 
type cntrl-d to abort type in* cntrl-p cntrl~c to abort run 
*COU<ALT>nt (file pages)<CR> 

listing only? Yes 

;if NO is specified then as a byproduct of the 
;count listing the working count (in the 
♦directory overhead block) is updated. 

entire file system? No 

directory: DIRECTOR Y-NAME<CR> 

; BSYS now types (on the controlling tty) 



^ pages (#) 



disc fnax= # 



directory-name ' # files 

*E<ALT>xit<CR> 

» the number following the word "pages" is The working 
; count and only appears if its different than the 
; actual count. 



counting the entire file system 

SEnabls 
!BSYS<CR> 
(site n3me)-( system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c 
*COU<ALT>nt (file pages)<CR> 



to abort run 



listing only? Yes<CR> 

♦if NO is specified then as a byproduct of the 
♦count listing the working count (in the 
♦directory overhead block) is updated, 
entire file system? Yes<CR> 
listing to file <cr> for tty: <CR> 
; ie: LPT:, tty: .. 

*ECALT>xit<CR> 
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DISMOUNT (magtape directory) 

This BSYS function Is intended for fixing magtape directories and 
should not be used except by knowledgeable systems people. 

LIST (magtaoe directory) 

What list does 

The listing function produces a directory listing for any BSYS 
dump tape. 

It also provides a feature to list the mapping of the file 

specified like the index or directory file that can 

be used to patch the file system instead of a complete re-load. 

How to do a list 



SEnable 
!BSYS<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in* cntrl-p cntrl-c to abort run 
*LI<ALT>st (magtape di rectory )<CR> 



ente r 
; " # " 
; ie : 

list 
enti r 
;if N! 
tape 

;if t 

tare 

;set 
» and 
*E<ALT> 



tape 
is th 

LPT: 
t ape 
e t ap 
o 

dir ec 
he ma 
liste 
when 
disk 
xit<C 



unit mta # listing to file <cr> for tty:<CR> 
e number of the tape unit 
» tty: .. 

mapping for files? No<CR> 
e? Yes<CR> 

tory: DIRECTORY-NAME<CR> 

pping was requested the pages of the file 

d along with the page protection word 

the file was dumped giving the protection 

page index. 

R> 



MOUNT (magtape directory) 

This BSYS function is intended for fixing magtape directories and 
should not be used except by knowledgeable systems people. 

OCTAL PRINT (of directory) 

What octal print does 

OCTAL produces a formated dump of either a system directory or 
a magtape directory. The dump produced is ala DDT and is quite 
useful in repairing smashed directories or simply verifying 
something about a directory* Try it you»ll like it. 

There is also an option to select the INDEX file for TENEX and 
select subindex 0»1»... This can also be very useful* 

How to do an octal print 

QEnable 
!3SYS<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl~c to abort run 
*0<ALT>ctal print (of di rectory )<CR> 



tape? Yes 
; If no is specified the tape request is omitted 

enter tape unit mta S 

use index file? No<CR> 
directory: DI RECTORY-M AME<CR> 

listing to file <cr> for tty: LPT:<CR> 

another? Yes<CR> 

use index file? Yes<CR> 

subindex number: #<CR> 

listing to file <cr> for tty: LPT:<CR> 

another? No<CR> 

* 

*E<ALT>xit<CR> 
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SAVE (archive directories on tape) 

What Sa\/e does 

Save dumps every archive directory to a tape to insure 
that users an/or the system don't clobber the user*s 
archive information 



How to do a save 
2Enab Le 
!bsys<CR> 

(site name) -( system) -bsys version date 

type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 
*SA<ALT>ve (ARCHIVE DIRECTORIES ON TAPE)<CR> 

entire file system ? No<CR> 
directory: DIR-NAME<CR> 
enter tape unit mta # 

; # ~ type proper unit number 
listing to file <cr>* for tty: <CR> 

; ie: lpt:» tty: .. 

new tape? Mo Cconf i rm3<CR> 

♦if yes then the following request 

tape number #<CR> 

; # - type tape number on tape reel 
more users? NoCCR> 
*EXIT<CR> 

TRIfl (user directories) for TENEX systems only 

What Trii! does 

Trim will process a directory (or all the directories in the 
file system) and delete all but the specified number of versions 
of each file in that directory. If "n" is greater than one BSYS 
retains the n-1 most recent versions and the oldest* However* 
Trim does not expunge these files* That is done in a separate 
oper at ion. 

How to do a trim 

SEnable 
»3SY3<:CR> 

(site name) -( sys tern ) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c to abort run 
*TR<ALT>im (user d irec tor 1 es ) <CR> 

enter number of versions to retain: #<CR> 

really? Yes<CR> 

entire file system? l\Io<CR> 

directory: DIRECTORY-f\lAME<CR> 

trim completed 

* 

*E<ALT>xit<CR> 

!RESET<CR> 

(In the aoovet "n" is the number of versions to be left 

undeleted. Usually this number is 1 (one)») 
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VlRIFY (user oirectorles) 



What Verify does 

Verify checks alL the pointers in the FDB (File Description 
Block) for every file in the directory^ If these pointers are 
not correct* BSYS cannot correct the problem* but will print an 
error concerning it* The conditions checked by BSYS are 
different from those checked by CHECKDSK. 

1> How to do an full system verify 

; <'^W> can be used to get a type out of the directory 

; and file bsys is presently verifying 
SEnable 
!BSYS<CR> 

(site name) -( system) -bsys version date 

type cntrl-d to abort type 1n» cntrl-p cntrl-c to abort run 

*V<ALT>erify (user directories )<CR> 

listing to file <cr> for tty! <CR> 

entire file system? Yes<CR> 

disc verify too? No<CR> 
verify complete 
*E<ALT>xit<CR> 
!RESET<CR> 

; normal mode is not to verify disc because 



of the time factor* 



2> How to do a single user verify 

8Enable 
!BSYS<CR> 

(site name) -( system) -bsys version date 
type cntrl-d to abort type in» cntrl-p cntrl-c 
*V<ALT>erify (user directo ries )<CR> 

listing to file <cr> for tty: <CR> 
entire file system? Mo<CR> 

directory: DIRECTOR Y-MAME<CR> 
disc verify too? No<CR> 

; the directory header information is printed 

♦for th5 directory of interest 
verify complete 
*E<ALT>xit<CR> 
!RESET<CR> 



to abort run 



3SYS - TOPS20 Backup SYStem 
0PERAT0=^3 MANUAL 



Page 23 



COMMAND SUMMARY 



APPEND 
ARCHIVE 
ARCHES 
AUDIT D 
BUILD { 
CLEAR ( 
CONFIGU 
COMTI^^!U 
COUNT ( 
DEBUG B 
DELETE 
DIS^OUN 
DUMP DI 
EXIT 
EXPA^JD 
FULL DU 
HELP 
IIMCREME 
INITIAL 
INSERT 
INTERRO 
LIST Ct 
LOAD FI 
M AP (us 
r-'iARK BA 



(two archive directories) 

(user f i Les ) 
(clear tape number from backup words) 
ISK USAGE 

archive directories) 
backup words in FDB's) 
RE (BSYS for another site) 
E DUHP 
file pages) 
SYS 

( deleted f i les ) 
T (magtape directory) 
RECTORY 

(archive directory to include site number and/or d1r string) 
^'lP (entire file system) 



MOUNT 

OCTAL 

PRINT 

PURGE 

QUIT 

REAPER 

RESTORE 

RETRIEV 

RUN THE 

SAVE (a 

SINGLE 

TAPE CO 

TRIM (u 

U^^MOUNT 

VERIFY 



NTAL 
I2E 3 
(dire 
GATE 
ape d 
LES ( 
er d1 
CKUP 
magta 
R I N T 
HE MA 
HOST 



DUMP 
SYS ( 
ctory 
(the 
i rect 
from 
recto 
WORDS 
pe d1 
(of d 
GTAPE 
FILES 



(changed f i les ) 
from given file) 

string after bdb 1n archive-directory) 
arch ive ) 
ory) 

magt ape ) 
ry ) 

rectory ) 
i rectory) 
ARCHIVE 



( F 
FI 

E ( 
f i 

rch 

FIL 

PY 

ser 
(m 

(us 



orce archive of files in dir over allocation) 

LES (from tape) 

archived files) 

le sys t em ( ut i I i t y ) 

ive directories on tape) 



directories) 
agtape directory) 
er director ies ) 
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ERRORS/ACTIONS 

Following is a list of errors that may be encountered using BSYS» 
Corrective action is suoplied if applicable. K'ormal error format is: 

"label: •••error text..^" 
label: is the BSYS program Label preceding the error and is meant to be 
used as a debugging aid to programmers, 
(errors are listed in alphabetical order without the "Label") 



ATTEMPT TO EXPAND TAPE 
This is a catastrop 
(contact responsible 

BLOCK SEQUENCE ERROR 
This error may be ig 
restoring a file. It 
and you should retry 
should contact the r 

CAN'T GET EXCEPTION LIS 

CAN^T OPEN EXCEPTION LI 
The above two errors 
List of directories 
check the file <ARCH 

CANT CLOSE ARCHIVE DIRE 
CLOSE jsys faiture a 
have sorneone check i 

CANT CLOSE MAGTAPE 

a random CLOSE js 

CANT GET USERS ARCHIV 

CANT OPEN ARCHIVE DIR 
Heans that BSYS ca 
archive run will b 
to make the entrie 
been rectified. Th 
(system or user) s 

CANT GET JFN FOR CONT 

CANT OPEN CONTINUE FI 

NO CONTINUE FILE?? EN 

NO CONTIMJE RECORD?? 

FAILED TO CLOSE CONTI 
All of the above e 
continue dump mech 
continue. BSYS is 
orogress . This is 
to restart with th 
inconvenient. This 

CANT WRITE TAPE HEADE 
This is a c atas tro 
responsibLe progra 

CLOSE JSYS FAILURE ?? 
a random CLOSE j s 

DATA ERROR READING FI 
Th i s error occu rs 
can generaLLy be i 



DIR BEYOND xxx PAGES 

hie failure and means 3SYS is really fouled 
programmer > • 



nored except when encountered whi 
is normally caused by tape unit m 
the restore. If the problem persi 

esponsible programmer. 

T FILE - TRIM ABORTED 

ST FILE - TRIM ABORTED 
are caused by BSYS's inabiLity to 

to except from the trim operation. 

IVE>BSYS-TRIH-EXCEPTIONS.; 1 

CTORY FILE 

nd can be ignored. If 1t happens reguLarly 

t out • 



Le actua L ty 
alf uncti on 
sts you 



get the 
you should 



ys f 

E DI 
ECTO 
nt g 
e ab 
s in 
is e 
hort 
INUE 
LE?? 
TERI 
ENTE 
NUE 
rr or 
ani s 
unab 
not 
e CO 

i s 
R - 
phi c 
mmer 



ai lu 
RECT 
RY 

et a 
orte 

the 
rror 
ages 

FIL 

ENT 
NG M 
RING 
DUMP 
s si 
m. S 
le t 
seri 
NTIN 
usua 
ABOR 

fai 
. Mo 



re - no action 
ORY 



ccess 
d and 
arch i 
is us 
• 

E? ? 
ERING 
ANUAL 
MANUA 
FILE? 
gnif y 
imp Ly 
o save 
ous un 
UE com 
L ly ca 
TING 
Lure a 
st pro 



to a 
the 
ve d 
ua IL 



MANU 
MODE 
L MO 

that 
supp 
the 
Less 
mand 
used 

nd s 

babL 



users archive dir 
BUILD function mus 
irectory once the 
y caused by disk s 



AL MODE 

DE 

something is wron 
Ly the data asked 
state of the dump 
the dump aborts a 
and even then it 
by disk space pro 

houLd be Looked at 
e cause is a bad t 



ectory. The 
t be used 
prob Lem has 
pace 



g with the 
for and 

whi le i n 
nd you wish, 
is j ust 
blems . 

by the 
ape. 



ys failure - no ac 

R3T RECORD OF FILE 
when positioning a 
gnored. 



t ion 

n 

tape to the desired file and 
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DIRECTORY NUMdER A 
This is caused 
only be en count 
oc curance is in 

ERROR WHILE WRITIN 

ERROR WRITING TAPE 
The above two 
The tape should 
failure should 
the data should 

irslVALID DIRECTORY 
Indicates ar\ 
contact res pons 

INVALID FILE DATA 
The f i le data r 
a problem excep 
function)* 

JSYS ERROR IN 
ERSTR jsys 

NO ROOM FOR NA 

There is n 

and is symp 

NON-EXISTENT D 
The DIRST j 
problem?) 

NON-EXISTENT T 
A pr e\/ ious I 
index plus 
should not 
troubles an 

SEQ err: 

block nuTib 
caused by t 
genera I can 
TA^E DIRECTORY 
BSYS attem 
cat ast roph i 
TAPE DIRECTORY 
Indie ates 
on this tap 
will work ! ) 
THIS TAPE DOES NOT 
IT*S NOT THE 1 
When reloading 
used f i rst » Aft 
TRIM FUNCTION TABL 
EXPAND TA3LE «E 
DIRECTORIES EXC 
UNDETERMINED TAPE 

TYPE ANY CHARACT 

UNEXPECTED 10 ERRO 

The above error 

cont ro I ler • Con 



LREADY USED ON THIS TAPE?? 
by reused directory number c 
ered when "appending" to an 
dicative of BSYS program pro 
6 TAPE HEADER 

DIRECTORY - PAGE # 
errors are indications of a 

be checked for "mountabi lit 
be copied (see TAPE copy fun 

be redumped. 
NUMBER FOR CNDIR 
invalid entry in the system 
idle programmer or TOPS2 pe 
(ZERO DIRNUM) 

ecord (FDBt filename* etc*.) 
t when rebuilding the direct 



onflicts and should 
old tape* Any other 
ble ms • 



bad or marginal tape, 
y" and in the event of 
ction) or if possible 



index hash table, 
ople. 

is bad. normally not 
ory (see TAPE copy 

I f I » 



This should not happen 



ERROR ROUTINE AAA AA A AAHHHHHHHHHHHH ! 

failure in the BSYS error routine. 

ME IN TAPE INDEX! ! 

o more space in the tape index. 

tomatic of a BSYS program proble 

IRECTORY NO. 

sys has failed on a valid directory number (TOPS20 



APE DIRECTORY NO. 
y identified directory cannot be 
the equivalent disk directory do 
normally happen and is symptomat 
d you should contact the respons 

ers on tape records are not cons 
ape unit malfunction or BSYS pro 

be ignored but if chronic shoul 

DISAPPEARED?? 
pt to remap a user tape director 
c problem and indicates BSYS pro 

SPACE EXHAUSTED DUE TO WRITE ER 
a Bad tape - no recovery - you 
e. ( note: in some cases TAPE co 



f oun 


d in the t 


ape 


es 


no 


t exist - 


this 


ic 


of 


BSYS prog 


ram 


ibl 


e 


progra mmer 


• 


ecu 


ti ve . Th is can be 


gram 


troubles. 


In 


d b 


e 


investigat 


ed. 


y f 


ai 


led - 




era 


m 


problem. 




ROR 


S 






mus 


t 


redump the 


data 


py 


wi 


th rebuild 


opti on 



CONTAIN DATA TO CREATE USER 
ST TAPE OF A DUMP .... 
the disc the first tape of a 
er that tapes may be loaded 
E OVERFLOW: 

XLST" OR DECREASE NUMBER OF 
EPTED 

ERROR PLEASE CHECK TAPE AND 
ER TO CONTINUE 
R INTERRUPT. ..IGNORED 
s indicate trouble with the 
tinued trouble of this type 



fu 
in 



II dump must be 
any order. 



tap 

mea 



e uni tor 

ns more or better 
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maintenance on hardware* 

UNRECOVERABLE ERROR WRITTING TRAILER 

TAPE IS G0OD(?) 3UTf NOT FOR FUTURE APPENDS 

TAPE MARKED AS FULL.*- 

Bad or marginal tape - no action 

UNRECOVERABLE TAPE READ ERROR 

BSYS is unable to read the data from a tape»Retry after mounting 
tape on another tape unit (if available) or cleaning the reed 
heads. 

UNRECOVERABLE TAPE READ ERROR ATTEMPTING TO CREATE USERS 

A read error has forced termination of the create users function 
of restore. Use the DLUSER subsystem to create the user 
directories and tyoe "no" to BSYS when asked to create users. 

UrvRECOVERABLE WRITE ERROR WRITING DIRECTORY 

WHITE ERROR IGNORED 

BSYS writes detected error records until no errors occur* this 
means recovery is possible (beware!). This usually indicates the 
tape in marginal at best and redumping is strongly advised. 



BSYS - TOPS20 Backup SYStem 
PROGRAMMERS MAMUAL 



Page 27 



PROGRAMMERS MANUAL 



IfMTROOUCTION 



BSYS basically runs the file system structure "calling" specific 
function rojtines for each file encountered. It does this by mapping 
the system INDEX and copying the user hash table* It then maps each 
user subdirectory into its space and then processes each symbol table 
entry by following the file extension and version chains (see appendix 
"<SYSTEM>D1RECT0RY FORMAT"). This allows for multiple functions to be 
performed on a single pass of the file systen* However this facility is 
not presently used. 

The flow of a typical BSYS command is as follows 



A 
deco 
flag 
for 
file 
proc 
and 
proc 
exte 
rout 
the 
setu 
call 



setup 
der/r 
(s> f 
getti 
S9 te 
esses 
then 
esses 
nsi on 
i nes 
mappe 
p rou 
rout 



and 

ecog 

or t 

ng a 

cnpor 

the 

call 

eac 

and 

(se 

d di 

tine 

ine 



initial 
n izer • T 
he selec 
II neces 
a ry file 

file <S 
ing the 
h entry 

version 
lected b 
rectory. 

needs o 
CHECK. 



izat 

his . 

ted 

sary 

s • . • 

YSTE 

rout 

in t 

FOB 
y f u 

In 
nly 



1 on 

setu 

comm 

fil 
). I 
M>DI 
ine 
he d 

cha 
ncti 
orde 
map 



rout 
p ro 
and. 
es : ( 
t th 
RECT 
CHEC 
irec 
ins» 
on f 
r to 
the 



ine 
ut in 

The 
list 
en c 
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K to 
tory 
Th 
lags 

pro 
appr 



IS ca 

e set 

setu 

ing d 

alls 

gett 

p roc 

symb 

e fun 

) are 

cess 

op ria 



lied by 
s th e n 
p r o u t i 
evice» 
the rou 
ing the 
ess tha 
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cal led 
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te subd 
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eces 
ne i 
mag 
ti ne 

"ne 
t di 
e ru 
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for 
e di 
irec 



com 
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s re 
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GMT 
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rect 
nnin 
cess 

eac 
rect 
tory 



fnand 
fun 

spon 

5 in 
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ory. 

g do 
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put 
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CHECK 
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MAKING A NEW BSYS 



creating a site specific version 

BSYS currently consists of 11 code files: 



<BSYS 
<BSYS 
<BSYS 
<BSYS 
CBSYS 
<BSYS 
<BSYS 
<BSY3 
<BSYS 
<BSYS 
<BSYS 
<BSYS 
<BSYS 



>6SYSCM 
>BSYSDF 
>BSYSDR 
>BSYSDV 
>BSYSER 
>BSYSFD 
>8SYSF^j 
>BSYSFS 
>BSYSFT 
>BSYSIN 
>BSYSTD 
>BSYSUT 
>GETPRM 



.MAC 

• MAC 
.MAC 
.MAC 
.MAC 

• MAC 
.MAC 
.MAC 
.MAC 

• MAC 
.MAC 
.MAC 

• MAC 



first level command 

def ini t ions 

dump/restore/archive 

device handlers 

error handlers 

file system processing 

function execution 

file system subroutines 

cross network code 

ini tia I izat ion 

tapedi rectory 

uti lit ies 

get configuration parameters 



You should obtain the most recent version of the macro code files 
You must then edit the parameters specified in the files In the 
sections of this manual dealing with configuration of BSYS and 
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archive-lookup. Please follow the convention of giving BSYS files 
at your site the same version numbers as the originals at SRI. 
This allows me to quickly determine the version of the BSYS you 
are running. Mow follow the instructions for assembling a new 
version of BSYS. If (when?) you encounter problems call me!! 

asseriibling a new version 

A CTL is provided for loading/assembling a new 3SYS* The file 
is <BSYS>ASiMBSY. CTL.Thi s procedure uses CCL and only assembles the 
changed files. The CCL driver file is <BSYS>ASMBS Y. CMD. 

SU8MIT ASM3SY>CTL 
ena 
conn bsys 

delete tenex and tops20 versions 
del bsys .exs • *»Dsys .sav. * 
exp . 

load bsys f i les 
load 2asfnbsy.cmd 



;3av'? tops20 version 

» 

sav bsys.exe.l 

? 

fsave tenexe version 

> 

csave bsys.sav 

» 

Jstart bsys to initialize 

* 

start 

exit 

> 

♦delete initial version (sri has saved configured version) 

del bsys.exe* 1 

exp 
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CCL 
bsy sdf .mac 
bsyscm • nac 
bsysJr. mac 
bsysd\/*n[iac 
bsyser.mac 
bsysf d.rnac 
bsysf n.mac 
bsysfs.mac 
bsy sf t ..mac 
bsysin.Tiac 
bsystd.Ttac 
osy sut .mac 
getprm.'n ac 



river file <BSYS> ASHBSY.CMD 
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ARCHIVE SYSTEM 



GENERAL DESCRIPTION 



The archive command is really just a special for:Ti of incremental 
dump with a different criteria for "inc rement a Iness "• 

** IMPORTANT NOTE ** 

BSYS duups a file on two (2) different tapes before it is 
considered archived. When it has been archived an entry is made 
in an archived files directory file» Entries are made in the form 
of a doubly strung list containing BACKUP DESCRIPTOR BLOCKS (BOB) 
plus name»extension and account strings. This has created the 
illusion for new users of the archive not working. As two passes 
(one each on different tapes) are required before any files are 
really archived. A standard operational ploy is to run the 
archive twice in a single evening to ensure all archivable files 
are really archived. This is obviously not necessary but none the 
less is still done. 



THE ARCHIVE COMMAND 

This command has two b 
listing mode 

Allows for gen 
speci fie userCs ) 
It will alternat 
and a list of f i 
to his message.t 
directories to " 
dumping mode 

This mode is e 
being has the f i 
days » where n i s 
The additional f 
3ARCHIVE-DIRECT0 



asic modes of operation: 

erating a list of "archivable" files for a 

or the entire file system, 
ively concatenate the file <BSYS>AR CHIVE-TEXT 
les to be archived for each user and append it 
xt file. It provides for mapping files-only 
owner" directories. 

ssentially "dump" with the dumping criteria 
le been written or referenced in the last "n" 

the run-time selected archival period, 
unction of making en tries in the file 
RYC.;! is accomplished on the marking "pass". 



MODIFICATION'S TO THE TOPS20 EXECUTIVE 

The following commands have been added to the EXECUTIVE to 
support archiving and retrieving of user files* 



EXEC Command to invoke archiving of a specific file 
3ARCHIVE subfunction filespecs C»3 optional comma 
subcommands **s are allowed in all fields 



invokes 



SUBFUNCTIONS: 



DELETE filespecs C»D mark the fileCs) as deleted 

this makes the file invisible to further archive 
status commands. This function can be reversed by 
the UNDELETE subfunction. 
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EXPUNGE all files that are marked as deleted. This file 
removes the entries from the archive directory and 
can not be undone 

FILE fllespecs C»3 marks the f1le(s) for archiving. 

RESET fllespecs C»3 reset f1le(s) archive status bits 
except for the already archived bit. 

STATUS fllespecs C»3 archive status of f1le(s) 

UNDELETE fllespecs C«3 clears the deleted bit 1n the 
f1leCs> bdb In the archive directory. 

subcommands: ($ means normal defaults) 

SaDEFERRED($) -archive this file at next regular archival 
run of BSYS 

esIMMEDIATE - (not Implemented yet) 

copy this file to directory <arch1ve> with a funny name and 
when regular archiving done archive It 1n original 
directories archive with the original name. 

3aD0N»T ARCHIVE - do not archive this file 
(BSYS will Ignore this file for all archival functions) 
this will Include deletion of the funny named file In 
<ARCHIVE> If one exists. 



S8DELETE(S) - delete this file after It Is archived 

aaDON»T DELETE - dont delete this file after It Is archived 

aSRESET ~ resets all archival attributes of this file, 
this does not "unarchlve" a file if It has been previously 
been archived. 

aSSTATUS - type the current "archival status" of the 
speclfledfile(s) 



EXEC CORHA^JD TO IMTERROGATE THE ARCHIVE DIRECTORY FILE 
SINTERROGATE (ARCHIVE) FILENAME 



either types "THAT F 
or "ARCHIVED ON Csit 
If the file is found 
"DO YOU WANT IT RETR 
is yes a message wll 
message contains tim 
reqjesters nanie» tty 

When the file has 
notified via the snd 

INTERROGATE has a 
the user to expand t 
specification and to 
file is specified in 
directory block <BDB 
in the section on In 



ILE IS NOT ARCHIVED" " 

e nickname 3T APES NNN AND MMM" 

in the archive directory file 
lEVED?" will be asked- If the answer 
I be logged on a special logger. The 
e and date* filename « tape nos»» 
♦ and job number, 
been retrieved the user will be 
msg f aci lity» 

number of subcomfTiands which allow 
he qualifications of the file 
get additional i nf o rrnat i on. Each 
the archive-directory by a backup 
)• The commands are specified 
terrogate subcommands* 
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FILES USED BY BSYS 



TAPEDI^ECTDRY.TMP 



purpose : 



This file is the tape analog of <system>di rec tory » It is built 
and dump (arch ive) time and is written on the tape after 
completion (as file 0)» 

format: 

It is identical in format to <SYSTEM>DIRECTOR Y with the 
following exceptions* 

The field "FDBADR" 'whi ch normally contains the disk address of 
the index block for a file contains the "tape address" of the 
first record of the file on tape* This address has the form 
xwd f i le#» block #• 

file# = sequential file number (directory is file 0) 
blocks = monotoni cal ly increasing tape block nui7?ber 

<SYSTEM> ARCH I VE-FILES-ONLY.TXT 

purpose : 

This file is an input file by the archive "deliver rnessages to 
user" function and is used to map FILES OMLY directories to 
owners* For files only directories* the list of archivable files 
will be delivered to the owners MAIL.TXT file 

format : 

It is a sequential text file (editable by teco)» It consists of 
directory name pairs* The user directory name must appear first* 
followed by by the files only directory name « separated by a 
comma ending in cr If (ie: USER♦FILES-0^iLY-OIR<crlf >) • Input 
is terminated by the first null entry (two crlf*s in a row). 

<ARCHIVE>ARC HI VE-HESSAGE.TXT 

purpose: 

This file contains an arbitrary message to be delivered to users 
who have "archivable files"* It is appended to the users 
message*txt file along with a list of the files to be archived* 

format : 



Sequential text file (editable by teco)* It is assumed to be an 
asciz string, message is terminated by the first null Co) byte* 
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<SYSTE:m>3SYS-EXCEPTED-DIRS - see BSYS function exceptions. 

<SYSTEH>3S YS^PARAHETERS ~ see BSYS configuration parameters. 

<$YSTEM>3SYS-FU,MCT I O.M -EXCEPT IONS 

pu rpose: 

This file is buiLt by bsys when the file B SYS-EXCE PTED-DIRS is 
changed. It is a binary file that is indexed by directory number 
and gives the flags set to correspond with the function 
specified. 

<SYSTEM>ASSOC.BSYS 

purpose: 

This file is used .to allow current directories to access obsolete 
directory files from the archive. It assums that the archive 
directory files have been merged and the parameter ASSOC has been 
set in the BSYS-EXCEPTED-DIRS file. 

format: 

The file is binary with the first two pages reserved to be 
indexed by directory number for a pointer to an asciz string 
of directory na?nes to be associated with this current directory 
as BSYS looks for the file requested from the archive. 

<SYSTEM> RETRIEVE -RE QUESTS. TXT 

purpose: 

This file is built by <SYSTEM>ARCHiy E-lOOKUP .S A V 
when the BSYS or exec INTERROGATE command is given. 
It is used to build the RETRI EVE-REQUESTS .BUJARY file that 
BSYS checks for retrieve requests. 

<SYSTE M>RE TR I EVE-RE QUEST S.B I NARY 

pu rpose : 

This file gives the requested file description including the 
directory to retrive into and the user requesting the file. 
The two archive tapes for each file are also given in the entry. 
At present there are a maximum of 40 requests processed by BSYS 
for the retrieve command. The rest are processed by the next 
retrieve command. 

<*>3ARCHIVE-DIRECT0RYC..l 

purpose : 

This file is a directory of all archived files for this 
directory. It is built by BSYS at archive marking time and is 
used by the EXEC command INTERROGATE to "lookup" archived files.. 

format: 



The file is binary and consists of two parts. 



word - next available free storage word 
word 1 - LH: pointer to current last BD3 
RH: pointer to first BD3 



d address 



a reserved block ( 6 octal words) 
free storage area! 
contains BDB's 



and strings associated with archived fil 



Backup (file) Directory BLock(BD3) definition 



the header (not referenced 



block 1 
symooli ca lly ) 
bdbctl: block 


1 


bdbext: 


b lock 


1 


bdbadr: 


block 


1 


bdbort : 
bdbadl: 
bdbad2: 
bdbver : 


block 
block 
b lock 
block 


1 
1 
1 

1 


bdbact: 


block 


1 



bdbusw: block 1 
;following is optional for SRI 
bdbsit: block 1 



bdblen: 



Ih = 
rh = 
Ih = 
rh = 
Ih = 
rh = 
file 
time 
time 
Ih = 
rh = 



control 
point er 
pointer 
pointer 
tape # o 
tape # o 
protecti 
and date 
and date 
versi on 
point er 



account info 
+ for locatio 
- for number 
user setable 
ross net retr 
Ih = dir stri 
rh = site num 
specifies sit 



bits <see be low ) 
to file name block 
to extension string 
to next bdb 
f 1st a rchi ve 
f 2nd archive 
on word 

of 1st archive 

of 2nd archive 
number 

to previous bdb 
for charging 
n of string 

word 

ieve (e xperimen taL) 

ng pointer (if it exists) 

ber where file is archived 

e and medium 
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Bits in LH of BDBCTL 
BD3Tr'iP_4 0000 
BOBPRH__2G0000 
BDBMEX 100000 



BOBDEL. 
BOBMXF 



.040000 
020000 



BDB»s 



BDBLNG_010000 
BDBSHT_00400C 
BOBFLG_00200G 
are doubly strung. 



(primariLy for FOB compatibility) 
;File is temporary 
;File is permanent (TENEX) 
;Mo extension for this bdb yet 

♦(File does not exist yet) 
;Fi I e is de leted 
;First write not 

•(File does not 
;Long file 

;Compressed page table(TENEX) 
♦This is a backup block (3DB) 
This is done to facilitate 



(bdb too) 
compl ete 
exist yet) 



reconstruction of archive directories. 



FIXING SMASHED DIRECTORIES FOR TENEX 

The need for piecing directories back together has diminished greatly 
since RST found the garoage collection bug a while back* but it is 
still necessary to perform this job once in a while. The following are 
some pointers as to how to accomplish this task for new TEWEX KI^4GS as 
well as some old timers. These methods are certainly TENEX version 
dependent* but have remained stable for some time. There are two kinds 
of smashed directories and each requies a different fix. 

Invalid Pointers* Strings* FDB»S etc.. 



This t 
major 
EXPUMG 
di ctat 
The BS 
di rect 
output 
one-by 
format 
g lobal 
data i 
ei t her 
below) 



ype of trouble can range from very minor (easy to fix) to 

foulups of almost everything. A system crash while 

ING a directory is a rather catastrophic eyent and may 

e following the Absolute Trash solution. 

YS VERIFY function will catch most problems with 

ories and should be used to "diagnose" the trouble. The 

of this function is a list of problems and can be used to 
-one fix them. The OCTAL PRINT function produces a 
ted dump of the directory and 1s quite useful in getting e 

view of the directory structure as well as the specific 
n the directory. To actually fix the bad data you can 

use the 3SYS MAP function or the MOOT mapdir method (see 



Absolute trash 

This situation is caused by a variety of glitches such as bugs* 
fat fingers* or flakey hardware but requires major surgery on the 
directory involved. The basic scheme is to "reinitialize" the 
directory so that it appears as though it is empty. This means 
the symbol table is empty and the free storage stuff is all 
reinitiali zed. 

In general the files in this directory will be lost or backed up 
to the last dump. GET into MDDT and 



1. map the directory as follows 
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l/d1rectorynjfi?ber 

2/ -1 

call mapdi rS x 

2» initialize directory 

1/ 25 ; most common block size (FD3 length) 

2/ 777 ;one page directory 
3/ directory number 
call lai blk$ X 

At this point the directory is locked so you must set 
DIR0RG(DIRECT in BSYS) to -1. Also all the attributes 
(protectiont groups* disk limits****) of this directory are set 
to the system defaults and must be reset with the CREATE exec 
command or any other suitable means* You can now reload the users 
files fro.T, valid dumps (be sure the disk allocation is set up!)* 

Some interesting data (TENEX) 

symbol table entries must be in ascending alphabetic order 

Account strings have an entry in the symbol table of the form 
XWD string pointer ♦* 100000 

XWD 400100»»25 - FOB header word 

XWD 400001f»# - filename string header word 
(# - string length + 1) 

XWD 400002»»# - extension string header word 
iU ~ string length + 1) 

XWD ~1*»# - account string header word 
(#=stringlength+2) 
The second word is a use count 



GENERAL file system PROCESSING 

Running The file system 

In the course of running a T0PS2G system situations arise where you 
would like to "process" all the files in a given directory or all 
the directories in the system and perform a "one time" modification 
or fix* albeit an infrequent requirement BSYS is an excellent 
vehicle to perform such operations* The command "RUN" is designed to 
process the file system* Control is passed to the dummy routine 
•DORUN once for each file* .DORUN is a block of 100 POPJ»s and can 
be used to either patch or assemble in any special functions you may 
desire. The state of the directory run is contained in a set of 
cells in BSYSDF ( cvf » cef ♦ adrf db* * * * ) and can be used to get 
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Information about the current* next or last file processed tie: file 
namet extension etc.). 

Mapping directories 



BS 
of m 
MAP 
s 
s 
a 
t 

11 y 

then 
and 
cool 
tunc 



YS provides an analogous function to the MODI call mapdir method 
apping user directories and inspecting or modifying them. The 
command has the following advantages! 
pecify the directory name (not number) 

pecify read/write access (a guard against fat fingers) 
bility to use any BSYS subroutines or prewritten user routines 
o perforrn fixups etc.. 

ou GET B3YS.SAV and go into DDT> put a breakpoint at cell BPLOC 
start BSYS (startSg). The MAP command will take the breakpoint 
you can do as you wish . $P will continue BSYS and all will be 
. Much thanks to ED TAFTaPARC for contributing this BSYS 
t ion. 



BSYS Magtape Format 

All files consist of "n" records and are separated by EOF marks. 
The record size depends on the installation as specified below. 
The first two words of each record have the following format. 



word 1 lh=^ not used 

rh= block number 
word 2 lh=; file number 

rh= page number 

where block number is a monot onica I ly increasing tape block sequence 
number* file number is the sequence number of this file (directory = 
file 0) and page number is the page number of the file as it would 
appear on disk. 

There are four special cases for word 2. 



word 2= -1 

word 2- -2 

word 2- file»f*-l 

word 2- f i le#» *~3 

Directory filet 



"unused" directory file block. 

user data record (for CRDIR) 
end of data record 
file data record (FOB + strings) 



The directory file is the only "rewritable" file on a BSYS format 
tape. This file consists of a header record (length= 64 words) and 
200 512 word "pages". Provision is made for this to be alterable as 
the number of directory pages is contained in the header record. 
This file is prewritten by BSYS by positive response to the question 
"NEW TAPE?". The rewritabilty of this file is accomplished by 
writting 12 inches of gap (blank tape) at the end of this file at 
initialization time and subsequently only writting o inches at 
rewrite time. This scheme has been quite successful at SRI as we 
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have not encountered any problems due to this process* 
Format of header record: 



tphdr: 
tpblk: 
t p n u m : 
nxtb Lk : 
usrb Ik : 
tpspac : 
tpf i Is: 
site: 
pages: 
tdpgs: 
tpseq: 
d b L k s : 
tapver : 
Lngf In : 
Lngnxt : 
Lngf st : 
tngnpg: 
reserve 
tptxt: 

The fo 
record 
tpid : 
Stanf or 
333 Rav 
M e n L o P 
(415)32 







0. 















"D200 










d: bloc 

block 
I Low da 
cannot 

asci 2 
d R e s e a 
ens wood 
ark t Ca 
6-S200/ 



he 
ta 
sa 
bl 
sp 

CO 

si 

CO 

ta 

CO 

20 
fo 
st 
ne 
fi 
lo 
k 2 
20 
t a is 
exceed 
/Ar 
r c h In 
Dr i ve 
L if orn 



ader i s 
pe numbe 
ved last 
ock U of 
ace left 
unt of # 
t e ni ckn 
unt # of 
pe direc 
nsecut iv 
blocks 
rmat ver 
art bloc 
xt tape 
rst tape 
ng file 

;id 
site dep 
64 word 
t i f i ca I 
st i tut e 

ia 94025 



block 
r 

block number used (this tape) 

1st record if user data file 

on tape 

of files on this tape 
ame 

pages used 
tory pages used 
e dump tape sequence count 

reseved for directories 
sion number of tape 
k»»file number for long file 
number for long file 

for long file 
number of pages 

entered by operator 
endent but the length of the header 
s • 
Intelligence Center 



Tape directory index: 

Subdirectory zero is used as an analog to the TEN EX file 
<SYSTEM>I!\}DEX and is used for mapping directory na.-ne to tape 
directory nuniber and vice versa. It has a symbol table ala 
regular directories with entries of the form: 

Ih - pointer to string block containing dir name 
rh - directory number 

This allows for independence of directory numbers on tape and 

disk. This solves the problem of deleting a directory and then 

subsequently creating another with the same name but different 

number • 

***ISI has forced all tapes to be written with 30 pages per directory as if 

they were all version 4. This means that TE^y!EX tapes are still tapver 3 but 

the tape directory is mapped with 30 pages /dir instead of 20. 

ib'hen a tape is read and the routine TODISC is called the tape 

directory size is determined by the first non-zero directory number on the 

tape. 
* *■* 



User Data Files (TENEX optional): 

This file consists of "n" records each containing all of 
the data necessary to create a directory (GTDIR). This file will 
only appear on tape created by a "full" dump. TOPS20 directories 
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File system Files: 

These files consists of "n+1" records corresponding to the "n" 
pages in the as it appeared on disk plus proceeded by one record 
containing the directory name* directory number* FOB* and all the 
strings associated with the file.. There is a one to one mapping 
between the "n" pages and the pages on the disk. There is no zero 
compression of files ala 1050 save files. 

T ra i ler Record : 

After the last file on the tape (for non-full tapes) a special 
record is written • This record is used for positional verification 
when adding files to a tape. This record is simply the first page of 
the "next" file that would be added with a -1 in the page number 
field 



Record Lengths: 

The lengths of the tape records are site dependent. The standard 
1s 515 (decimal). The HDRLNG ♦BLKLNGt SDMFLG* and EIOFLG BSYS 
configuration parameters determine the record length. 
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KNOWN DEFICIENCIES OR GLITCHES 

DEFICIE^JCIES: 

1) The Trim (excess file versions) function should use the "default 

file retention" field as its criteria in deleting files. It presently 

asks the operator for the number to keep. 

2> The LOAD comiiand is implemented but will default to <SYSTEr4> if the 

"to" directory is not specified. 

3) The cross network retrieval code is still in development. 

^) The T0PS2 logi cal names are not supported by interrogate. 

GLITCHES: 

1) The "deliver to users" option of the archive cominand was designed 
and implemented before the advent of SNDMSG and its resultant rigid 
MESSAGE.TXT file format restrictions. The method used for generation of 
the BSYS archival list makes it difficult if not impossible to supply 
the length of the message in a SiMDMSG type header. A possible solution 
is to get MAILER to deliver the messages (since it supplies a header In 
SMDMSG format). This would require BSYS to drop out a file of the type 
MAILER likes and "poke mailer". This seems like a rather round about 
way to get things done and a such nothing has been done. Thus the 
"deliver to users function" is rather useless in its present form but 
could be fixed if anyone comes up with a better solution or a need for 
its use. 

2) The record size of the "user data" record has been changed from 64 
to normally 514 words. This was done because of a persistent error 
message when working with tapes containing the data to recreate users. 
This has the effect that the restore entire file system function is 
incompatible with "old" 3SYS tapes. This is thought to be a rather 
unlikely event (to be restoring a non-current file system!)* but if 
there is a need to do such a thing the cell RWRCRD must be changed 
from lOWD ''D514»3LKN0 to lOWD ''D64,BLKN0. The '*D514 is again site 
dependen t . 
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BSYS configuration parameters 



Name 
acsst r 

arcnms 
ardf Lg 
arcpro 
bdbsiz 



Type 

as c1 z string 



asci z string 

0/1 

asciz string 

octa L value 



blkLng octal value 



chpflg 0/1 



crnflg 0/1 



drsflg 0/1 



dydstr asciz string 



eioflg 0/1 



Desc 
( cr 
whi 
num 
and 
nam 
def 
0/1 
def 
pro 
con 
s iz 
def 
opt 
bdb 
tap 
def 
opt 



ript 

OSS 

ch s 
ber s 

ter 
e of 
ault 

- a 
ault 
tect 
vert 
e of 
ault 
iona 

whi 
e da 
ault 
iona 



1/0 - c 
default 
opt iona 

1/0 - c 
default 
opt iona 

1/0 - a 
def au It 
to end 
opt iona 
i nsert i 
of bdbs 
f unct io 
default 
opt iona 
listing 
where t 
and ex 



1/0 - e 
default 
opt iona 



ion 

net only) 

pec if y the 

for this 
mina^ed by 

archive d 

- CvXru 
I ways dele 

- delet 
ion for ar 
ed to a nu 

bdb entri 

- 12 word 
I ~ 13 wor 
ch include 
ta block I 

- 1003 - 

I - 1104 t 

betwee 

heck for v 

- -don* 
I - 1 - ve 

in 
ross net c 

- - no 

I - 1 - cr 

(s 

dd dir str 

- - don 
of each bd 
I - 1- App 
ng pointer 
it (only a 
n I is ti ngs 

- all aut 
I st ri ng o 
s will go 
pnum is ta 
t is: ARC 

FUL 
INC 
xtended/du 

- - duiTJ 
I ~ 1 - ex 

ta 
sw 
an 

CO 

bl 



a string o 

accept abl 
site. Sepe 

an extra 
irectory f 
bout) ("v)D 
te/de lete 
e after ar 
chive dire 
meric valu 
es in arch 
s per bdb 
ds per bdb 
s sitnum 
ength 
normal 
o allow IS 
n their KA 
alid user/ 
t check 
rify that 

<system>b 
ode/none 
cross net 
OSS net re 
till exper 
ing to bdb 
♦t append 
b. 
end dir st 

to dir st 
fter bdb»s 

to <daily 
onrat i c lis 
f function 
to OAILY- 
pe number 
for archiv 
for full d 
for increm 
mpi Co) ins 
pi/dumpo 5 
tended cod 
pes for IS 
itched bet 
d tops20 s 
njunct ion 
king param 



f octal numbers 

e cross si te 

rated by commas 

comma • 

ile 

archive-directory('*v)C 

if over allocation 

chive 

ctory 

e for tenex systems 

ive dir 

for SRI cross net 



I to switch tapes 
and KL 

don»t 

user name appears 
sys-allowed-users»lst 

code 

trieves for SRI 

imant al) 

»s/don*t 

direc tor y st ring 

ring to end of bdb 
ring in left half 

have been expanded 
-dump> 

tings to LPT: 
s whose automatic 
DUMP>tpnum.sxt 
input by operator 
e listing 
ump listing 
ental I i stings 
truct ion 
sys* 

e to write/read 
I which can be 
ween the ir tenex 
ystems* Used in 
with hdrlng and 
s* 
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fmtver octal value 



fundrs asciz string 
hdrlng octal value 



jbzflg octal value 



mftflg 0/1 



nd1 rs octal value 

niknam asciz string 

per fig 1/0 

priflg 0/1 



savflg 0/1 



s dm fig octal value 



s iteC asciz st r ing 

sitnum octal value 
spool asciz string 



file sy 
opt ions 



1 - 

2 - 

3 - 



ten 
ten 
wor 
ten 
wor 

4 - top 

5 - top 
name of 
tape he 
default 
opt iona 



1/0 - r 
default 



stem 

ava 

ex s 



ex 
ds 
ex 
ds 
s 



c 

p 

c 

p 

20 



s 20 
fun 

ader 
- 1 

I - 



un a 
- 



optional - 



1/0 - c 
in tape 
default 
opt iona 
generat 
max imum 
ni cknam 
1/0 - p 
1/0 - p 
default 
opt iona 

1/0 - s 
default 
opt iona 

0/# - i 
default 



heck 

hea 

~ 

I - 

e pr 

num 

e to 

erpe 

r ior 

- 
I - 

ave 

- 
I - 

gnor 

- 



opt ional 



tape nu 
tape nu 
site nu 
cross-n 



mber 
mber 
mber 
et s 



direc 
i table 
plit d 
ompact 
er dat 
ompact 
er dat 

norma 

expan 
ct ion 

block 

00 wor 
110 wo 
tapes 
tops 2 
s job 

- don 
sys 

1 - al 

of 
for e 
der 

- don 
1 ~ ch 
oper t 
ber of 

be sp 
tual b 
ity js 

- no 

1 - SR 
8S 
a f ter 

- don 
1 - sa 

CO 

e/set 

- don 
mod 

4 - se 
4 

fo 

heade 

is re 

for c 

pool d 



tory size 

irector y f 

di rectory 
a record ) 

di rectory 
a record ) 
I direc tor 
ded dir si 
except i on 

length 
d tape hea 
rd header 
between th 
systems. 
zero 

n run BSY 
tem verifi 
low 3SYS t 

job zero 
xtra word 



ormat 
format 

format 

y size ( 
ze (60 b 
file if 

ders 
for ISI 
eir tene 



S as job 
cati on o 
o be run 



C^dSl^ 

C'dDlS 

30 b locks ) 

locks) 

it exists 



to switc h 
X and 



zero for 
n start up 
as part 



♦t ch 
eck f 
ape h 
di re 
ecif i 
it fo 
y s av 
prior 
I ten 
YS to 
conf i 
•t sa 
ve BS 
nf i gu 
data 
»t se 
e 

t tap 
( " i n d 
r ISI 
r st r 
quest 
ross 
irect 



eck f 
or tw 
eader 
ct ori 
ed if 
r arc 
ai l/n 
ity j 
ex sk 

get 
g/ don 
ve CO 
YS af 
rat io 
mode 
t top 

e dat 
us try 
t ape 
ing t 
ed f r 
net r 
or y ( 



as part of site 

or two word site 
o word header and 

format 
es on system 

not in host table 
hive dir/none 
one 

sys* available 
usr jsys to enable 
hi gher priority 
*t s ave 
nfigured BSYS 
ter init ia I 
n 

s 20 tape data 



a mode t 
compata 
switchi 
o be pri 
om opera 
et rieva I 
def au It : 



ble mode") 

ng« 

nted when 

tor 

s 

bsys-spoo I) 
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tod -fig 0/1 



tpc rid 
tpccfnp 
tp1 dp 



0/1 
0/1 
asd z 



unlflg 0/1 



1/0 - special td1r mapping/none 
default - - no special mapping 
optional - 1 - ISI developed code to be 

intelligent for mapping directories 
from tape which no longer exist in the 
file system 
;following two parameters for tape cop/ 

0/1 - optional rebuild/always rebuild 
0/1 - optional compare/never compare 
string ;tape id - name and address of site for 
the version of BSYS is being run 
1/0 - unload tapes/rewind tapes 
default - 1 - unload tapes after BSYS is done 
optional - - rewind only for SRI drives 

which don»t have unload 




arcnms:asciz /darchive-directoryc/ 

ACSSTRIASCIZ /2»f/ 

CHPFLGIl 

EIOFLGrO 

CRMFLG=1 

PRIFLSri 

todflg:o 
tpcrld:o 
tpccimpio 
savflg:i 

FHrVER:5 
NDIRS:1400 
HDRLISiGriOO 
3LKLMG:100 3 
BDB3IZ:i3 

suhuh:?. 

XCPFLGri 

dydstr:asciz /archive»full, incremental/ 

SITE0:ASCIZ / AIC tape / 

TPIDP:ASCIZ /Artificial Intelligence Center 

Stanford Research Institute 

333 Ravens wood Drive 

Menlo Parkt California 94025 

(415)326"6200/ 



BSYS - TOPS20 Backup SYStem 

PROGRAMMERS MANUAL 



Page 



43 



ARCril VE-LOOKUP configuration parameters 



Name 
a rcnms 

a re pro 
lokdro 



Type 

asciz string 

octal V3 Lue 

asc 1 z string 



ndirs octal value 
niknam asciz string 
savflg 0/1 



sitnuin octal value 



Description 
name of archive directory file 

default - ( ''v) ( rubout ) C^v) 3arch1 ve-directory ('*v)E 
protection for archive directory 
name of directory where arc hi ve- loo kup 
reside. Used in connection with savflg for 
saving configured version of BSYS. 
default - SUBSYS 

maximum number of directories on system 
nickname to be specified if not in host table 
1/0 - save after config/don't save 
default - - don't save configured BSYS 
optional - 1 - save BSYS after initial 

configuration 
site number for cross net retrievals 
(still exper imaental) 



The following is the confguration file for the KL system 
at SRI. The parameters do not have to appear in any order but any 
parameter specified in the file must appear in the above list. If 
the default value is desired* the parameter specification need not 
appear. The file Cai c 3<system>lookup .parameters contains: 



ARCMMSZASCIZ 
SAVFLGri 
WDIRS:i4 
SIT!\IUM:2 



/3ARCHIVE-DIRECT0RYC/ 
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BSYS Function excpetions 

BSYS uss a flLe to determine which functions are to be excepted 
for which directories. For example « if there are certain directories 
which are to be excepted from archiving and or incremental dumps* 
their names would be included in <system>bsys-except ed-di rs» BSYS 
uses this asciz string file to create a bit table file 
<SYSTEM>bsys-f unc t i on-except ions which it uses for checking to see 
if the presently specified function is to be performed any or all 
directories. A new version of bsys-f unct ion-excep t ions is created 
anytime BSYS is started up and BSYS determines that bsys-exc epted-di rs 
file has been changed. 



The format of <systein>bsys-excepted-di rs is a directory 
name string terminated by a colon and followed by the name(s) of 
functions to be excepted for the specified directory. The 
exception file for SRI KL system appaers below as an example* 
The example shows that the directory SPOOL is to be excepted 
from archive and incremental' dump functions and ROOT-DIRECTORY 
is to only be excepted from archive. 

The following functions are acceptable after the 
directory specification: 



the 



ARCHIVE 

ASSOC - 
in the < 

AUDIT - 
COU.MT - 



DUMP - D 

FULL - D 

INCREMEM 
?1SG - Do 
PURGE - 

SAVE - D 

TRIM - D 

UPRVER - 



- Do 
acce 
This 
SYST 
Don» 
Don» 
(Ten 
in t 
dire 
on* t 
f unc 
on* t 
full 
TAL 
n*t 
Don* 
(f il 
on»t 
dire 
on't 
t his 
Don 
unle 



nn 

pt s 

di r 

EH>A 

t sh 

t sh 

ex s 

he d 

ctor 

dum 

t ion 

dum 

sys 

- Do 

send 

t pu 

est 

sav 

ctor 

tri 

dir 

•t a 

ss s 



auto 
peci 
ecto 
SSOC 
ow d 
ow d 
ide 
ir ec 

y.) 

P fi 
>• 

P fi 

tem 

n»t 

mes 
rge 
hat 
e th 

y* 

m i n 
ecto 
uto 
pec i 



archive from this directory* but 
fie archive requests. 

ry has access to directories specified 
.BSYS file. 

isk usage for this directory, 
isk usage for this directory, 
affect - replace the count presently 
tory by that just calculated for the 

les from this directory (DUMP BSYS 

les from this directory as part of a 

dump (normally all di rec tories > • 

dump change files from this directory. 

sage after the retrieve request to this director 

ghost files from this directory 

don^t exist yet). 

e archive directory from this 

termediate versions of files in 

ry. 

archive the highest version of any files 

fically requested. 
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BSYS- 
ROOT- 
GEOFF 
GEOFF 
lOlB- 
lOlB- 
lOlB- 
lOlB- 
DOCUR 
SOURC 
SY3TE 
SUBSY 
NEWSY 
SUPPO 
FRONT 
3INAR 
MFEXE 
DEV-R 

tv:ar 
m:arc 
c:arc 
fe:ar 



s? 

DI 

:a 
2: 

MO 
SO 

su 

EX 
EN 
ES 

h: 
s: 
s: 

RT 

-E 

y: 

c I 

SE 
CH 
HI 
HI 
CH 



00 L 
REC 
RCH 
ARC 
MIT 
URC 
BSY 

EC: 

TAT 
: AR 
ARC 
ARC 
ARC 

:ar 
i\iD: 

ARC 

ARC 

XEC 

IVE 

VE 

VE 

IVE 



: ar chi ve» incremental 
tory:archive 

IVE 

HIVE 

or: ARCHIVE 

es: archive 
s:archive 

ARCHIVE 

ion: ARCHIVE 

CHIVE 

HIVE 

HIVE 

HIVE 

CHIVE 

ARCHIVE 

HIVE 

HIVE 

:archive 
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Interrogate subcommands 



CJ 0) 

as 

33 
da; 



A^L. 
info 
BEFO 
spec 
DATE 
DELE 
DOUB 
EVER 
INDI 
info 
cont 
alio 
The 

8 





<l 


<c 


ci3LPT 


aawo.H 


uiSNUHB 


S30UTP 


S3PR0T 


SaREVE 


23SINC 


33STAT 


33TAPE 


S3TIME 


S3VERB 


33CARR 



FILES - di 
mati on « 
RE. DATE - 
i f i ed date 
S - print 
TED. FILES. 
LE. SPACE - 
YTHING - a 
VIDUAL - s 
rmation an 
inuing* Th 
wing si mpl 
user comma 

- backup t 

- mark thi 
only whe 
is typed 

- go back 

- retrieve 
file ret 
conseque 
ret ri eve 

- unde let e 
If the A 
are sele 
displaye 

- up arrow 
f> - displ 
r> - displ 
~ I ist i ng 
EADING - d 
ERS - abso 
UT. TO. FILE 
ECTION - p 
RSE. ORDER 
E.DATE " d 
US - delet 

- tape nj 
S. AMD. DATE 
OSE - full 
I AGE RETUR 



splays deleted and undeleted bdb 
only display files archived befor 



out dates when file was erch 
OMLY - only display deleted 

listing format control. 
II data for f i les. 
elect option to display file 
d wait for user command befo 
is option interacts with the 
tied retrieval of multiple f 
nds arel 

o previous file data 
s bdb as deleted. The bdb go 
n an "ARCHIVE EXPUNGE" EXEC 



to ex 
this 
ri eve 
ntly 
a la 
the 
LL .F I 
cted 
d and 
is s 
ay ne 
ay ne 
to LP 
onn 
lute 

- li 
r i nt 
- di s 
ispla 
e/und 
mber 
S - w 
pri n 
N TO 



ec. 

file 
d" qu 
this 
rge n 
prese 
LES o 
then 

can 
ame a 
xt fi 
xt fi 

t: 

print 
index 
sti ng 
prote 
play 
y dat 
elete 
assoc 
hen f 
t of 
GO - 



es 

is 

um 

nt 

r 

de 

CO 

s 

le 

le 



The "Do you want 
tion is not aske 
an easier way t 
ber of f i les. 
ly displayed f i I 
DELETED. FILES. ON 
leted bdb»s will 
nsequently be un 
"B" backup comma 



i v e d . 

files (bdb) 



re 

user 
i les. 



es away 
command 



this 
d and 
o 

e (BDB). 
LY options 

be 
deleted, 
nd. 



headi ng • 

of bdb in archive-directory. 

to specified file* 
ct i on of f i le. 
oldest Ddb data first, 
a for files since date spec. 

status of bdb. 
iated with file spec, 
i le was archived, 
command data* 
start display of files. 
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The following commands are undocumented at the present 
time* but will oe added in the near future* 



BSYS - TOPS20 Backup SYStem 

PROGRAMMERS HANJAL 



Page ^9 



INDEX 



ARCHIVE SYSTEM 16»3a 

archiving user files: • • » » • • . 17 

BSYS Magtape Format 36 

COMMAND SUiMMARY •••.. 23 

Configuring BSYS ••. ..40 

Configuring archive-Lookup . .... 43 
Continuing Dumps •.•••.••••8 

COI^VEMTIONS ....2 

COUNT (directory file pages) .... 18 

DISMOUNT (magtape directory) . ... 20 

Dumping a User Directory(s) .... 5 

Dumping the entire file system ... 4 

DUflPS 3 

ERRORS/ ACT IONS 24 

file system UTILITIES 18 

FILES USED BY BSYS 32 

FIXING SMASHED DIRECTORIES 34 

Function exceptions ....••..44 

GENERAL file system PROCESSING ... 35 

Incremental Dumps ....••.•.6 

Interrogating the magtape archive: . 17 
Interrogate subcommands. ...... 47 

INTRODUCTION 2 

KNOWN DEFICIENCIES OR GLITCHES . . . 



bsyscrn - added "bypass restore checks *' question to initial RESTURE 

code. Cleanup RETRIEVE subcommana code. Add EXIT to RETRIEVE 

subcommand to return to BSYS primary command level. Added auto 

heading code for archive ♦full and increoicntal dumps. Added 

auto heading to SAVE function. Clean up RETRIEVE coae. 

Make tape copy, be smart about EUI on write. 

Expanded list to be able to select one directory off the 

tape to list. 

Hade tape copy code finally work. 

Added append archive directories conrndnd and code. 

Added insert directory string after Ddb in archive directory 

(requires expanded ar ch i ve-^d i rector y ) . 

Fixed octal dump so that it uses directory numoer from tape 

for aunspino directories from tape (required changes to 

Dsysut " user code ) . 

Auded initialize command to checK out bsvs .paramter s files 

before they are installed on the system. 

Dsysdf * Added new cross net site number and Derf Iq for nev^ perflq 
initialization parameter. 

nsysor "Add perpetual file bit chfdb instruction. Provide more 
information for GETARC failure. Aaded code to tapdsk 
to clear archive pending, dump not complete and dumper bits from 
backup f lag bits. 

Hade reading fo the fdb data at the beqininq of the f i le 
into a seperate routine to enable the reading pages at the 
end of a 1 on q file ( p a q e number 77777? specifically) 

bsysdv " Added cooe to tapei so that 1) bSYS ^\]\ accept any BSYS tape 

format (ie. 100»ilO octal header lenqtht 51 1 . , b 12 . ♦ . . . data record 

length). Z) In conjunction with a s/witcn in todisct allow differnt 

start numbers for record number sequencing (olkno). 

Put in auto continue for tape sequerice numtjer difference 

o f o n 1 y 1 , 

Aaded chkptn tape code to attempt to reaa the tape before 

writinq dummy directory. If the taj-.e is an archive tape» 

then bsys halts. If-i it it is a dump tapet then osys will 

ask if the user wishes to continue. Addition to an 

existing tape is not affected. 

Corrected lonqstandinq problems connected with eot 

process i nq. 

Added code to ptfile to make searcnin-^ down tapes 

faster by eltminatinci reading of tne fob data from tne 

front of each file until the tape is close to the 

file number of i n te r e s t . 

bsvsfd •" Corrected a bug in cntrol whicli prevented specific arcnives 
from directories which haa auto archives excepted 

usysfn - Aaded code for append archive directories 

Aoded code to insert dir string in archive directory bdb's 
Modified expand and bdb puilding code to support append and 
insert functions. 

Added isi code to prevent overwrite of perpetual files on 
r e store. 

Expanded bidrst to allow (via drsflg) append! rig of a dir 
string to the end of bdb's. (future plans call for the 
adding of a symbol table to the archive directory to keep 
track of dir strings "associated witn various bdo's) 
doded code to allow (via the exceptions file code ) to 
auto archive all but the nighest version of a file which 
has not been read in "n days". 

L' 5 y 5 f s - Fixed bugs in the full r e s t o r e cod e . 

t: s / s i n " A d c e d code for perpetual bit c a p a b i 1 1 y 



[J s y s t d 



D s y s u t - 



rearranged code 
properly 
F i xsd buqs in t 
F i X buq in a ] ] f 
code for determ 
to keep it frOiTi 
header does not 
that copy will 
t ronf! the file s 
Aaded code to i 
s tr i nq from peg 
corrected ion a 
Corrected anc ie 
index of direct 
A a d e a s s c a n and 
single tape d i r 
Lhanqed td i rst 
s y s t e [fi d i r n u ti . 
■Added tuser to 
s y s t e m . 



so that the in it coTimand would work 

he qe.tcmd code. 

Is. add code to todisc to correspond to tape? 

ininq tape record lenqths. Added checK in scan 
running a*^ay if nuiiDer of paqes in tape 
match actual r e a a in. Added code to i n i 1 1 d so 

copy the data as it is on trjpe and not do dirst's 

y s t e ni . 

nittd so that on tape copy* BSYS will get the 

e+100 instead of a oirst. 

file paae count prop lent in drtipeott 

nt buqs in the code used to expand the 

or i es on the tape . 
e X p a n d e a s c d n t o a 1 I o vv scan n i n q o f 

e c t o r y . 

so that it a! 11 rsot aetaLilt to the file 

qet user nujiber from tape instead of file 



O-MAY-76 21 : ^3: *^a"PDT , 1097 J 00000 00 00 00 i 
ote: b AUG 197^ 2U3-P0T 
r o'li : NAGt L 
uDiectt DbYS 3, 02 

BSYS InFG 

B ■» a " 7^ 



\lA VhKbiljN Of bSYS HAS BFEN" INST ^LLtU . THh NL:W BSYS JFFhRS 



<LC Nci'. FbATURtS THAT NILL ALLOW THE UScK 
b. i bt AKlHIVlu fills. THt THRFE FtAlURcS 
ONDtLLTE. INSTALLATION ijF THE NE w bSYS 
CdiVt LIST TO kEAO "TAPE 0". THIS SHOULD 
L NEW FEATURES ARE DESCRIBED BELOW. 



ID MANIPULATE THEIR 
AKl ilMERKUGATbi DELETE, 
HAS CAUSED SOME OF THE 
liE IGfiURED BY THE USER. 



v-:SYS (Ck) 

l-^bX'^bSYS 3.0 2 6'«AUG«*74 

'•'INIERRUGATE (THt ARCHIVE) (CR) 

'^.'f;'^' , ULTHGuE COhMA WILL GbT YOU iRTQ SOBCUMMAND 



iibL .FILES 

ji: Lb TEiJ . Fl LE S. Only 

U!\DFL£1 c. U . F i LE S. ONLY 

V L ■< i:> U S E 

b VER YTHl NG 

bAlES 

Ti:iES. AND. DATES 

PKJTECTIGN 

3i FORE .DATE 

S i !^ C E . D A T E 

DEJBLE. SPACE 

''^i J . H b A i -M G 

RE VERSE .ORDER 

jUIPUT. Tu.FILE 



LPT 

CARRlAGt RETURN TO GO 



BSYS DELETE AND UNDELETE FUNCTIUN 

vutLcTE (AKCHIVl ENTRY) (CR) 

r iLLNiAHL.EXT;VER I CONFIRM] (CR) 

'njKuELizlE (ARCHIVE ENTRY) (CR) 

r iLL-NJAME.EXT;VEK ICONFIRI'1] ( CR ) 

-cXIT (Ck) 

c^ *r iw Lji m tan. i0- 

1 i-Aor-78 i6:iO:35-PST, 1706 ; 000000000 001 
u^te: 11 Apr 197b 1610-PST 

rrornJ riMUURE 

Si. o iect: bSYS chanqes 

; u ! i restore on topsZO should work now. The directory files from the 
f oot:*d i rectory are dumped at the beqining of each inc or full dump. The 
tripe ci rectory is not told that the files are there because there is not 
tefiouqh room in the tape directory* A temporary file called RUTDIRECTORY •TMP 
is generated from these files and used to create users and for restore checks. 

A list of directories is checked to prevent the jar ch i ve^'d i rector y 1 file from 
[einq generated at the time pf the archive. ( pr i n ter ,xqp » . . et c . ) 

i r.e octal print ccmiTiand allows the INDEX fi le to t*e specified and gives the 
torfnat of the sub indices that are selected for tenex. 

Tne Duilo command generates the arch i ve^c i r ector y entries from the second 
laoe of tne archive only. 

Non-^'or i V i 1 eged users may dump their own directories with BSYS. 

Ihe perpetual and ephemeral bits are restored frosn tenex tapes to tenex sites. 

Tne load command can store files or qroups of files from a tape 
directory to the same or other system directory as ne^^^ files. 

The wild card, *> » should work now. 

Arcltivct Gumpj restore and retrieve of fnulti-tape files should work no^. 



Tne nap function with write access should work now for tops20* 



7 fie Daqe mapDinq for a file can be specified with the list command. 
Uie nark command will now connect to tne airectorv that is specified 



The delete subcommand to retrieve should .vork now. 



! ■, i. 



! fj- '^ooe for UPKVER'" don't auto archive the niqhe.st version of any files 
unless specifically requested" has been fixed. 



r\2 automatic listing nas been takan out for archive. 



U* W UB M 1 



i7-AUG«-76 11 :02:41«PDT, 323; 000000000000 

bate: 17 AUG 1978 1102-PDT 

F r cm: N'^UOKE 

liubject: BSYS.SAV;50456 

Don't archive the lARCH I VE-Dl RECT OR Yl file. 

AGd ASSOC parameter to access old directories. 

Don't clear tape with ARCHES If the archive date is older than /m hours 

T5<e the extra eof out of the tape copy after writing the directory. 



/.^-AUG-76 17U6:57»PDT, 120; 000000000000 

Date: 2^ AUG 197B 1716*PDT 

From: WMOORE . 

Dub ject: B SY S. SAV ; !:>0^39 

Ine REAPER command has been i Tip lemsnted . 

&i» «*» «■ I3t 4S »« Mfr 

^.8 -AUG" 76 i7:06:28"'PDT,21<+;000000000000 
Date: 26 AUG 1978 1706*PDT 
Frofn: N HOD RE 
SuDject: b SYS; 50 "^60 

Permanent files are dumped even if deleted ana have zero paqes. 

The dump listings print the directory name even if no files are dumped. 

30-AUG-78 13: 36 :5'-)"PDT, 276; 000000000000 
Date: 30 AUG 1976 1336«PDT 
l-rom: W MOD RE 
SuDject: bSYS; 50461 

Ine subcommand for retrieve will noi^ list lar.je t.if^e numbers. 

Ifie check for extstinq file for retrieve has been chanqed. 



ie incremental dump w?]l list only directories that have files dumped. 



15-DeC«78 iO : 33 :49«P ST, 257; 000000000000 
Uote: 15 DEC 1978 1033-PST 
From : W MOO RE ■ . 

Suojecti BSYS;5046'^ 



Implement conversion of time and date between tenex and tops20 vs/hen 
restorinq, loading, retrjevinq, and single file transfer of files 
^vriten on one system and read into the ot ner. 



